---
title: "get body · RUAL Documentation"
description: "Returns the provided body as object, if the request method is POST or PUT."
canonical: https://docs.rual.nl/block-types/http connection/httpconnection_get_body
language: en
---

# get body

This block is part of the [`http connection`](https://docs.rual.nl/block-types/http%20connection) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

Returns the provided body as object, if the request method is `POST` or `PUT`.

- connection required `httpconnection`

- body `object`

[get body](https://docs.rual.nl/block-types/http connection/httpconnection_get_body) reads the request body as an object from the [current request](https://docs.rual.nl/block-types/http connection/httpconnection_current_request). [get fields](https://docs.rual.nl/block-types/object/object_field_getter_multiple) then picks the fields the handler needs, and [reply in JSON](https://docs.rual.nl/block-types/http connection/httpconnection_set_json) answers the call.

![Studio canvas example for the get body block: reading the posted body.](https://docs.rual.nl/canvas-examples/httpconnection_get_body.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [current request](https://docs.rual.nl/block-types/http%20connection/httpconnection_current_request): feeds into this block. Retrieves a reference to the current HTTP Connection.

- [get fields](https://docs.rual.nl/block-types/object/object_field_getter_multiple): this block feeds into it. Gets the selected fields from the given object.

- [selected fields to mutations](https://docs.rual.nl/block-types/object/object_field_to_mutations): this block feeds into it. Gets the selected fields from the given object and returns a fresh mutations from it.

- [log](https://docs.rual.nl/block-types/logging/function_console_log): this block feeds into it.

- [fields exist](https://docs.rual.nl/block-types/object/object_field_exists_multiple): this block feeds into it.

- [custom field](https://docs.rual.nl/block-types/object/object_get_custom_field): this block feeds into it. get the value of a custom field with a custom value block, or dynamic value.

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).